FAQ

Is there an ipad or iphone version of OpenCPN?

When will OpenCPN be ported to Android?

- There are two versions in the Google Play Store. We suggest you will be happiest with the paid version created by D. Register because it is updated regularly and is current. There is a forum at http://bigdumboat.com/aocpn/forum/ .

Activating route at desired waypoint?

- Activate the route first. Then you can activate a specific waypoint within it.

Many error messages when starting OpenCPN from Linux command line.

Messages like: * “ALSA lib pcm.c:2217:(snd_pcm_open_noupdate) Unknown PCM cards.pcm.side ALSA lib audio/pcm_bluetooth.c:1614:(audioservice_expect) BT_GET_CAPABILITIES failed : Input/output error(5)” or * “(opencpn:8979): Gdk-CRITICAL : IA_gdk_drawable_get_size: assertion `GDK_IS_DRAWABLE (drawable)' failed” * '(opencpn:8979): Gdk-CRITICAL : IA_gdk_drawable_get_depth: assertion `GDK_IS_DRAWABLE (drawable)' failed Error opening coefficient file“ * ”(opencpn:8979): Gdk-CRITICAL : IA_gdk_window_get_origin: assertion `GDK_IS_WINDOW (window)' failed“ are quite normal and have nothing to do with OpenCPN. Just ignore them!

Where are Plugins Stored?

- Please read Where are PI and PM plugins stored?

Many of my Navobjects and waypoints disappeared. Why?

  1. Try using the “V” shortcut key which shows/hides Hides/shows all navobjects. The only exceptions being the active route and track which are always drawn on the chart canvas.

What causes spurious waypoints which must be deleted?

  1. Condition: Multitude of repeated waypoints, which get copied when a waypoint is dragged. Sometimes a route WP is shifted, two routes are made, one with the name, the other unnamed.
  2. Possible Solutions: Determine if the addition of waypoints are from inadvertently hitting the wrong keys on the keyboard, or the mouse.
  3. The other possiblity is that the navobj change file is corrupted. Close O and try to delete the change file In W8.1 it is found in C:\ProgramData\opencpn/navobj.xml.changes. Normally, after that O will work again.

What causes random waypoints dropped at the cursor

One possibility is that you have the space-bar set to drop a wpt at the boats position. This used to be standard behavior some time ago. If this is a problem, shut down OpenCPN. Open the file opencpn.ini, find the line:

 SpaceDropMark=1  and change it to   SpaceDropMark=0 

Save and restart O.

What happened to zoom to cursor?

Can I use my Seaclear wci or OziCharts?

See Use-seaclear-wci-charts and Oziexplorer to Opencpn Also see Not supported formats that can be converted and Map2Kap and WCI Charts

How to import Routes?

  1. Receive waypoints in GPX-file from an external source which are arranged in the intended travel sequence. However, the GPX doesn't include direct routes between those waypoints.
  2. Import the waypoints to OpenCPN and the order in the Waypoint and Route Manager is correct.
  3. How to create a direct route between those waypoints in OpenCPN automatically without editing the gpx-file?
    1. Best way to do this, by “forcing the text file to be generated as route points”, then generate Route from track in the Route & mark manager.
    2. Manual Route creation by Start route creation. (Ctrl + r or right mouse click menu), Then click first WP and accept “Use nearby WP” and so on.
    3. GPS Babel may help you out if the handcrafting feels annoying.
    4. Use a Text Editor to form the xml list of waypoints into a route to conform to the xml format.

<CODE> <rte>

  <name>test2edit</name>
  <extensions>
     [DATA}
  </extensions>
  <rtept lat="57.679627692" lon="11.796954074">
     [ROUTE DATA]
  </rtept>
  <rtept lat="57.679627692" lon="11.796954074">
     [ROUTE DATA]
  </rtept>

<rte> </CODE>

Can I import SeaClear routes and waypoints into OpenCPN?

Can I import Maxsea Waypoints and Tracks?

No, not directly, they are in different formats. But you can convert them with the GPS Utility Program. Here's an older writeup Conversion of MaxSea Routes and Tracks Use an external tool to convert the proprietary Maxsea data to the open GPX format. Either the free C2GPXKML or shareware GPSUtility could help. Also if you have access to Maxsea, export all waypoints as Gpx and OpenCPN will read the gpx file. If different color waypoints is used, export them separately and and in a text editor change icon name to an icon used in OpenCPN.

Can WPL Nema waypoints be imported?

See CF Adding waypoint from outside OpenCPN

Yes the NMEA WPL can be handled by OCPN but not the way you may want.

How to synchronize Routes, Waypoints & Marks with another computer?

Three ways to synchronize:

The navobj.xml file resides in the same folder as the opencpn.ini settings file, under the OpenCPN User folder. For windows this is usually “C:\programdata\opencpn\”. The navobject.xml file is in in fact a .gpx file containing all waypoints/routes/tracks. See Navigation Data Backup for more information.

Make a script or batch file to copy to navobject.xml file. Make an icon for the batch file on your desktop. Examples: Make an icon for the batch file on your desktop.

Copy-Routes-AB.bat

Copy \\ComputerA-name\C:\ProgramData\opencpn\navobj.xml \\ComputerB-name\C:\ProgramData\opencpn\navobj.xml

Copy-Routes-BA.bat

Copy \\ComputerB-name\C:\ProgramData\opencpn\navobj.xml \\ComputerA-name\C:\ProgramData\opencpn\navobj.xml

For more discussion see Cruiser Forum Thread Real-time sharing waypoints and routes

Can I restore my Route, Wpts or Track from backups? Somehow?

If you did delete the original [route, wpt, track], you may still have an automatic backup in an older navobj.xml.[1-5] file. Don't restart Opencpn again, until you retrieve the data you want. See Navigation Data Backup for more information.

Why are Routes, Tracks and Anchorwatch not saved?

This problem has been traced to shutdown management. Please see Tracker FS#2245 and OpenCPN and Linux powerup/down management For Windows and MAC users it is suggested that it is best to shutdown OpenCPN first, then shutdown the Computer.

Split a Route

Question: How to split a long route into shorter segments with each segment having its own start and end waypoint? When the split function is used, I get a new route name with an _B suffix, but it's still physically “connected” to the original route (now with a _A suffix) with a segment line connecting the two. I want to end up with two distinct routes that are not connected. How do I do that? Answer: The point where you did split the route exists now twice as start of one and end of the other route. Just hide one of the two routes and move the waypoint you are interested in as you like. Or insert additional waypoints and delete the first one.

The quick way to change the ScaMin value (ov50 feature) for a lot of waypoints and/or layers?

Waypoint Name: Waypoint properties names box is unchecked. Quick way to checked globally?

So that the names show up beside each waypoint as it is placed? There is not a very easy way, but one at least much easier then you do now.

  1. Run O open the routemanager and select and export the routes you want to change.
  2. Then open the exported route(s) in a editor (notebook?) and do a text find and replace.
  3. Search for ”<opencpn:auto_name>1</opencpn:auto_name>“
  4. and replace with ” <opencpn:viz_name>1</opencpn:viz_name> <opencpn:auto_name>1</opencpn:auto_name> “
  5. Close the editor, run O again and import the altered route(s).

Now you should have all waypoint names visible.

I converted a Track accidentally to a Route. Can I get the track back?

This depends on what “a bit ago” actually is - (if you have since started OpenCPN more than 5 times, every time did some change to the navigation objects and did not change the default settings for backups, you don't have it anymore) - If you do not have that backup anymore, you may still export the route as GPX file which you may later edit in a text editor and make a track again (But you already have lost some precision as during the conversion to route the points recorded in the original track are interpolated to limit their total number) - Later: your track seems to still be there as the yellow highlight it has seems to be visible, so you should be good just deleting the route.

Export Selected Tracks, only last track appears to be selected in GE?

When you export multiple routes or tracks in one operation they are all written to a single GPX file. That might be why you think only the last one is being exported. When you import the GPX file all the routes or tracks it contains will be restored. Note: In GE the Track looks strange, although all are marked visible, only one track at a time is shown.

Imported Routes, How to remove duplicates easily?

Deleted all routes in the Route & Mark Manager. Found a gpx Route File folder under documents on my computer. Importing all gpx routes into Route & Mark Manager from Route folder by highlighting all the routes. Now multiple routes with the same name show. How can I correct this. Importing a route at a time is tedious.

I had previously exported all visible routes and had that file in my GPX Route folder. What happened: I imported single listed routes by highlighting all the files in my GPX Route folder. However I didn't notice the gpx file which had a group of routes contained in it. Once I removed the gpx file with a group of files, the import gpx worked as anticipated.

What is the utility or purpose of the GUID box on the waypoint extended properties page?

The GUID box is not useful for anything but knowing the GUID. Knowing the GUID is good to be able to find a specific object in OpenCPN's GPX data when processed in a text editor. Doing things with OpenCPN's GPX data in a text editor is something you normally don't do, but when you do, you are most happy that you know the GUID of a certain object.

Why is own ship pointing towards COG instead of directly towards the bow, and there is no magnetic heading?

Enable thw WMM World Magnetic Model please.

It makes no sense to use magnetic on true north facing mercator projections.

Ownship true north heading predictor is only displayed if true north value is available.

If HDT is not available in the nmea data stream we use HDM and variation from the WMM plugin to estimate an effective HDT.

Jumping and Uncontrollable Mouse with Win10 and USB hub

See this CF Thread

  1. Solution 1: No need to edit registry. Works for all versions of Windows.
  2. Open device manager. (usually through control panel.)
  3. Expand “Ports (COM and LPT)”
  4. Right click on the port that is messing up the mouse and click properties.
  5. Click Port settings→Advanced and turn Serial Enumerator off.
  6. It should be ok to turn Serial Enumerator off on everything except the actual mouse.
  7. If the mouse not working, how can it be possible to do the above? Good question: Do this when the effect is intermittant.

Solution 2: Disable Serial Mouse Detection

Charts jump while Using Follow Ship Offset, Look Ahead & North up Modes

Chart Rotation Smoothing. When follow ship, offset mode, look ahead mode and north up mode are all turned on, the goal of the look ahead is to position the ship about 2/3 away from the farthest point directly ahead of the ship. Because the screen is a rectangle, the ship's position on the screen keeps changing, since the farthest point ahead is changing rapidly. Use Options > Display > Advanced Chart Rotation Averaging Time [new title] or Course-up Update Period _Time [old title] to smooth the chart rotation. It is actually another “always on” COG filter that smooths VP rotation and makes the chart much less jumpy. In conjunction with NMEA course and speed filtering the chart moves slowly in a nice way. Chart rotation averaging time” set to at least 15 sec.

Why is OpenCPN slow?

Why is ENC Vector chart display slow?

Scroll-to-zoom is unusable

Behavior: Expected -chart zooms in / out ONE level Actual -chart zooms in / out a crazy amount; mouse zooms 10 levels in / out Turn on Options > Display > General > Smooth Panning/Zooming

Auto Follow won't work

Very Choppy Chart panning after "Navigate to Here"

Disable Options > Connections > “Output this port (as autopilot or NMEA repeater)”, particularly if it is doing nothing. Once I unchecked the issue goes away.

Why are Mouse zooms very sensitive and hard to control?

The scale jumps appear very large. I have looked but cannot find a pref or other setting. It may be due to the scales of raster charts.

AIS Target Range and bearing does not work in a stationary operation?

OpenCPN requires a valid ownship GPS location to calculate range and bearing to AIS targets. It was not designed for stationary operation to monitor live AIS traffic without GPS input. If you insist, you may use VDR plugin , by running a text file with a single GPRMC nmea sentence describing your homebase location, repeated over and over….this will work, try this in a text file: $GPRMC,180000.000,A,4221.0000,N,07106.0000,W,0.00,180.00,101017,,,*3E<cr><lf>

AIS Targets HDG and COG may be wildly different

The TRUE Heading reported in the target query is always as actually reported by the target. We do not apply variation to that value before presentation. So, what you see is no error. Of course, in situations with strong cross currents, or maneuvering, the reported HDG and COG may be wildly different.

AIS Target List does not show range

A valid GPS data input is required to produce range and bearing data for AIS targets. It will not use the “move boat here” coordinate. You can use the VDRplayer plugin and a previously recorded file to test this.

Why is AIS target mouse rollover info is not shown?

Make sure that Options→User Interface→“ Enable Route/AIS info block” is ticked before you spend more time on the issue. This is a new option. One reason for the new option relates to touch-screens. Since there is no concept of “mouse hover” on a touch screen, the “rollover” can only be activated when the user touches the AIS target on screen. On the other hand, the user also touches the screen to move the chart,zoom, etc. Some find that having these target rollover boxes pop up willy-nilly can be distracting. So, we add a method to turn them off.

How can a SART Alarm be disabled or ignored?

MOB SART has been tested extensively. The methods for deactivation should work. See SART. Also Disable SART When Alert is active, find the Alert's MMSI number in the AIS Target List. Then Add a “New” MMSI number in Options→Ships→MMSI. Then Edit the Options→Ships→MMSI Properties to “ignore” this target. Then close the Options Dialog. Then “Acknowledge” the SART alert one more time, and no further alerts will be seen. If you restart OCPN, you will never get alerts for this target again.

How can an AIS alert be disabled, blocked or ignored?

How to block (filter) the AIVDO sentance?

See Ships Icon fluctuates AIVDO is the “ownship” sentence. It contains position information. My own AIS does not send one, it sends RMC and a GG? (there are a couple). Don't know why, some programmer's selection. You can confirm in the NMEA Debug window. Removing it is under Options|Connections. For each connection you can filter sentences by checking either the “Accept only sentences” or the “Ignore sentences” option, then put the sentence names in the filter box below (if the filter box is empty then this is ignored). You can use the ellipsis (…) to the right of the filter box to get a list of sentences. This is easiest if you run the debug window, then you can see what sentences you are receiving and accept/ignore those you want to filter.

What is the MMSIname CSV file for?

The file aids with faster display of vessel name, until first static information message is received from that vessel, which then overrides the cached value. Usually found in your user folder, for Windows C:/program files (x86)/programdate/opencpn/ Please see the AIS section under mmsiname CSV

Can the MMSIname CSV be edited?

Yes, unless you break it. As it is created automatically, it is also safe to delete it. Please see Cruiser Forum post by Nohal for more answers.

How to send routes to GPS via USB or via NMEA Serial connection

There are so many GPS models that the answer is a bit complicated. A lot depends on which GPS model you have. OpenCPN can communicate with many GPS receivers via a serial connection. Some GPS receivers have a serial connector that can be wired to a DB-9 serial connector. Newer ones have a USB port that will appear like a serial connection to your computer. Still newer ones appear to your computer like an external drive.

If your GPS receiver shows up as a serial connection on your computer chances are you can upload routes and waypoints directly to it from within OpenCPN. The GPS and OpenCPN have to be set to the same communication protocol. If you normally have them set to NMEA (for updating the OpenCPN chart display with position data from the GPS) you may need to change a Garmin GPS to the GRMN proprietary protocol to upload routes, waypoints, and tracks. If your GPS doesn't show up as a serial connection you may still be able to transfer routes and waypoints to it outside of OpenCPN. If the GPS appears as an external drive on your computer try this. Use OpenCPN to export your routes and waypoints to a GPX file (read the User Manual section on the Route & Mark Manager for more details). Then use your operating system to copy the GPX file from your hard drive to your GPS. If that doesn't work, try GPSBabel or EasyGPS for the transfer.

Depending on your GPS model and the way the route was created in OpenCPN you may wind up with a route on your GPS or just a list of waypoints. The route points may or may not appear as waypoints on the GPS.

There are also some good Cruiser Forum threads about Garmin

Night time Mode Title bar is too bright in Windows

Windows: Dialog frame label not dimmed on Color Scheme toggle

Read this.

  1. Opening the properties page, and adding a link to a JPG-image works fine. If I now edit the link, the image will no longer be displayed.
    1. The button “Edit” changes state. You click on it to switch the links above to “edit mode”, each click on any of the links opens the dialog allowing you to change it's parameters. After editing the link, you have to click on the button again and then a click on the links will again start opening whatever they link to. What will happen when you click on the link is explained in the text below the buttons and changes according to the “Edit button”. If it says “Links are opened in the default browser”, the linked file or internet address should open, given it exists, which gets us to..
  2. Similarily, if I export a waypoint with a link to another computer, the link will not open.
    1. The link is just a link, the file you link to is NOT “included” in the waypoint. When you transfer the waypoints to another computer, for links to local files to keep working, the files you link to would have to exist on the exactly same place on your disk there. Eg. The file that on computer A is C:\MyDocuments\MyPicture.jpg would have to exist with exactly the same file name, in the exactly same folder, on the exactly same disk on computer B.

OpenCPN and Great Circle Navigation

  1. There is a Route Plugin for Great Circles.
  2. Raster charts display bearings and headings as straight, measurable lines on the chart. Similarly, Vector ENC's are rendered as Mercator projections in OpenCPN and most other ECS's for the same reason.
  3. For typical coastal navigation, errors which occur using rhumb line instead of great circle calculations are small for the distances usually covered by one chart.
  4. Mercator Charts and Mercator navigation is the standard for most navigational purposes. Other terms used instead of “Mercator Sailing” is “Loxodrome Sailing” or “Rhumb Line Sailing”.

OpenCPN 3.2.0 forward handles Great Circles directly

Mouse rollover feature becomes disabled

'Enable Touchscreen interface' in Options/User Interface disables the rollover feature on my PC with a touchscreen. With this setting enabled, touching a target displays the target information. Without it enabled the rollover feature works.

“Rollover” is a mouse thing. One does not exactly “rollover” with a touchscreen. This could get very distracting to the overall UI. Thus, rollover is disabled for touch.

OpenCPN with Touchscreen for RPI arm64

See FAQ above, OpenCPN supports some Touchscreen, however there is an totally independent development and special BETA version available that needs testing. See Cruiser Forum Thread Open CPN on a Touchscreen?

How to save Toolbar and Dashboard position?

  1. Start OCPN. Set the toolbar as you would like it. No dashboard visible yet.
  2. Grab a screenshot.
  3. Exit OCPN cleanly by closing the Opencpn window normally. Restart and the settings should be saved.
  4. Using the Raspberry Pi shutdown, top left corner, select shutdown, is wrong, like instant stop.

Why aren't settings saved properly when I close Opencpn? -due to Inland ECDIS is checked

Not saving settings when exiting -due to Inland ECDIS is checked

Always starts up with the Night Palette - due to Inland ECDIS is checked

Issue just started with 4.8.0 where on exit doesn't save * Units * Configuration of toolbar * Starts in night mode I searched the opencpn.ini for these settings but not sure what I am looking for TBH. I also backed up this file and exited the program forming a new ini file, same issue. Any ideas?

OpenCPN is probably set to use settings for Inland ECDIS European Inland Waterways ECDIS

Right-click > Navigate > To Here has a problem

The new Active Route always disappears and I try to recreate it and it disappears again.

How exactly does NMEA 0183 HDG Sentence work?

If HDG message also contains the variation and E/W flags then O will use that. If not then it will look in RMC message for a variation. If nothing there it will use WMM plugin unless user has selected the variation manually in options.

How do I save many waypoints to a Layer?

Question: Layers is a good feature, however I need a tool to create a layer with many waypoints (say 200 waypoints in Fiji). I'd like create a layer of all visible waypoints in a chart area that I have zoomed into. After creating the layer, I'd like to delete them from the waypoints list with a single command.

Answer: Using the Route & Mark Manager

How to join or combine two or more Routes into a Single Route?

  1. Mark the routes in the Route&Mark Manager, recording the order.
  2. Then export each route as a gpx file.
  3. Open the first file in a text editor.
  4. Open the next file in the text editor and copy the code between <rte> … </rte> not including them.
  5. Then paste the code directly before the </rte> at the end of the first file.
  6. Continue until done. Save the first file.
  7. Import the gpx file with a new name.

Why don't AIS and Watchdog Sound Alarms work on RPI?

Distorted sound

mpg123 -2 -m -w out.wav in.mp3 This is on a Raspberry PI using OpenPlotter 1.1.0 alpha)

No Sound in RPI:

RPI display errors

RPI 3B+ is running now for several hours with OpenCPN and chart open. No more locks ups or screen errors. VC4 driver on and in OpenCPN also OpenGL to on. Fast screen movements. Something seems to go wrong with the auto screen detection in OpenCPN. Use manual screen settings to set the proper display size. Back to kernel 4.14.62 ( 4.14.68 kernel and 4.14.69 and 67 seems to have also a memory leak) the system is runs all day without problems and with OpenGL switched on. Screen is an DVI with a conversion plug DVI > HDMI.

MAC OpenCPN seems to freeze. Why?

Going to Toolbar/Options/Plugins/Grib 4.1/Preferences; OpenCPN freezes when you check “Authorize interpolation to start at current time” (a warning first followed by a freeze requiring a “Force Quit” of the application).

How to Set Local Time

Set time to local for weather routing in view→settings. Set time to local for grib_pi in preferences.

How can I change my Ownship Icon?

A user can install his or her own icons to use with marks and “own ship”. See Install your own Icons “To replace the default own ship icon, red ship icon just put a file “ownship.xpm” or “ownship.png” in the UserIcons directory.”

ChartDownloader is missing

If you are using WindowsXP, it will not appear because WinXP does not support the encryption requiired. Sorry.

Opencpn.ini Options How to add boat position WP?

Add a Boat Position waypoint

[Settings]
SpaceDropMark=1

to the opencpn.ini file you get at the boat position every time you press the space-bar.

How to fix Ubuntu 18.04 Options Menu display anomyly?

See Moving Options Menu, shifts to and changes Opencpn Window-Min- Max in Ubuntu 18.04 #1787 A Desktop Manager workaround is required. Not possible to change behavior in OCPN.

For Ubuntu 18.04, Gnome desktop: One should install the package “Gnome Tweaks”, and change the setting “Windows→AttachModalDialogs” to OFF.

Function 'Filter NMEA/Course and Speed data' not honored if input thru Signal K

See #2292 If an NMEA 2000 GPS is connected and Signal K is used to read NMEA 2000 into OpenCPN the data will not honor the filter settings for NMEA/Course and Speed data. The course predictor will jump both in length and direction, not damped by the filter setting.

I can find also SOG/COG from SignalK data stream is passing the filter function. (by PostProcessNMEA()) But the filter function is by-passed if “Calculate SOG and COG from position changes” is enabled in Options→Ships→Own ship. Pls check. I was falling into that trap myself.

How to use XBox with OpenCPN